Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Application Messages

GXFinishPage

QuickDraw GX sends the GXFinishPage message when spooling of a page is finished. You can override the GXFinishPage message to perform any action required at the end of each page. Your override of the GXFinishPage message must match the following formal declaration:

OSErr MyFinishPage (void);

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends this message when an application calls the GXFinishPage function to complete a page.

You need to override this message if you want to perform an action at the end of each page. QuickDraw GX sends the GXFinishPage message once for each GXStartPage message that is sent. This message indicates that the data has been drawn and that it can be written to the spool file.

The default implementation of GXFinishPage completes the associated page and spools the data for the page by sending the GXSpoolPage message. It also releases the view ports that were captured when the GXStartPage message was sent.

SPECIAL CONSIDERATIONS

You never send the GXFinishPage message yourself.

You must forward the GXFinishPage message to other message handlers.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXFinishPage function is described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help